AMENDMENTS TO THE SPECIFICATION 

On page 33, paragraph [0063] through page 47, paragraph [0086] (paragraph [0086] 

carries over to page 48), please replace the original paragraphs with the following amended 
paragraphs (new paragraphs [0064] through [0088]) to correct paragraph numbering of the 
specification. The copy of the originally filed application erroneously included two 
paragraphs numbered [0063] and two paragraphs numbered [0085]. A clean copy of the 
replacement paragraphs is attached hereto as Appendix A. 

{©063} [00641 FrameworkException is the other abstract subclass of WPAException and has 
the same types of constructors as FeatureException. The FrameworkException class may 
employ constructors similar to those discussed with respect to the FeatureException class. 
Each concrete subclass of FrameworkException should have an error code defined within it, 
and each time a new instance of that exception is created, the error code is passed to the 
appropriate superclass constructor. 

{0064} [00651 BusinessException is one of the two abstract subclasses of FeatureException. 
Services must subclass this class for all business exceptions. Each concrete subclass should 
have an error code defined within it, and each time a new instance of that exception is 
created, the error code is passed to the appropriate superclass constructor. Because the class 
is abstract, it may have constructors that have the same format as FrameworkException and 
FeatureException. 

{0065} [00661 SystemException is the other abstract subclass of FeatureException. 
Accordingly the SystemException constructors may follow the same format as 
BusinessException, FrameworkException, and FeatureException. 
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{©066} [00671 Each concrete subclass of WPAException should define an error code that is 
passed to the appropriate superclass constructor. Developers of web applications in 
accordance with embodiments of the present invention may use the following constructors 
when creating new exceptions, where ConcreteException should be substituted with the 
actual name of the concrete exception: 

public ConcreteException() - This constructor is called when there is no additional 
information other than that included in the error catalog that should be written to the error log 
file 

public ConcreteException(String errorMessage) - This is used when the programmer would 
like to log an additional message, perhaps to state exactly what occurred. 

public ConcreteException(DiagnosticContext diagnosticContext) - Here, a diagnostic context 
object is added. The object should contain information about the context of the error, such as 
variable values, that can be used for debugging. 

public ConcreteException(Exception caughtException) - This constructor is used when the 
ConcreteException is created as a result of another exception being caught. Using this 
constructor preserves the sequence of exceptions for possible output to the error trace log. 

public ConcreteException(DiagnosticContext diagnosticContext, Exception 
caughtException) - When both a diagnostic context object and a caught exception are present, 
this constructor is called. It combines the added features of the previous two constructors. 
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[0067] f 00681 WPAErrorActionForward is an abstract superclass for action forwards that are 
created when a page must be displayed to a user due to some caught exception. The 
following constructors may be used in conjunction with the WPAErrorActionForward class: 

public WPAErrorActionForward(WPAException wpae, HttpServletRequest request, String 
path) - The path parameter is the path to the page that should be displayed. It also obtains an 
instance to the TransactionProxy object. 

public WPAErrorActionForward(String errorCode, HttpServletRequest request, String path) - 
The path parameter is the path to the page that should be displayed. This constructor is used 
for interactions with other architectures, where an error result is returned. It also obtains an 
instance to the TransactionProxy object. 

protected void logError() - This method calls the TransactionProxy 's logError() method and 
stores the error data in the transaction for later logging. 

protected void logBusinessActivityStatusQ - This method stores the error code and success 
indicator for use in logging to the business activity log file. 

protected abstract void log() - This method must be instantiated by a concrete subclass. It 
controls storing information for logging. 

protected void setSuccessIndicator(int indicator) - This class is called by the subclasses to set 
the success indicator before the logBusinessActivityStatusQ method is called. 
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public Object clone() - This method returns a copy of this WPAErrorActionForward instance. 

{©©68} [0069] WPABusinessErrorActionForward is a class that may be used to display an 
error page to the user after a business exception. The following constructors may be 
employed in conjunction with the WPABusinessErrorActionForward class: 

public WPABusinessErrorActionForward(BusinessException e, HttpServletRequest request, 
String resultClassName, ActionMapping mapping) - This constructor enables the business 
activity data to be extracted and logged. For this constructor, the WPAException must be a 
concrete instance of a BusinessException. The action mapping and the resultClassName are 
used to get the path of the page to be displayed. 

public WPABusinessErrorActionForward(String businessErrorCode, HttpServletRequest 
request, String resultClassName, ActionMapping mapping) - This constructor is used for 
interactions with other architectures, where an error result is returned. This constructor 
enables the business activity data to be extracted and logged. For this constructor, the 
businessErrorCode is the error code of the business exception. The action mapping and the 
resultClassName are used to get the path of the page to be displayed. 

private void process() - This method extracts the data from the exception and stores it in the 
ErrorlnfoBean for possible access by JSP page. This method also calls the log method. 

protected void log() - This method controls storing information for logging. 

public Object clone() - This method returns a copy of this WPABusinessErrorActionForward 
instance. 
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{©©69} [00701 An instance of a WPASystemErrorActionForward may be created when an 
error page should be displayed to a user because of an instance of a concrete subclass of 
SystemException or Frame workException. The following constructors may be employed in 
conjunction with the WPASystemErrorActionForward class: 

public WPASystemErrorActionForward(SystemException wpae, HttpServletRequest request, 
ActionMapping mapping) - This constructor enables the error data to be extracted and 
logged. For this constructor, the WPAException must be a concrete instance of a 
SystemException. The ActionMapping object may be used in conjunction with a portal 
property specified in configuration resource file 152 (FIG. 2) to get the path of the error page 
to be displayed. 

public WPASystemErrorActionForward(FrameworkException wpae, HttpServletRequest 
request, ActionMapping mapping) - This constructor enables the error data to be extracted 
and logged. For this constructor, the WPAException must be a concrete instance of a 
FrameworkException. The ActionMapping object may be used in conjunction with a portal 
property specified in configuration resource file 152 (FIG.2 ) to get the path of the error page 
to be displayed. 

public WPASystemErrorActionForward(String systemErrorCode, HttpServletRequest 
request, ActionMapping mapping) - This constructor is used for interactions with other 
architectures, where an error result is returned. This constructor enables the error data to be 
extracted and logged. For this constructor, the systemErrorCode is the error code of the 
system exception. The ActionMapping object may be used in conjunction with a portal 
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property specified in configuration resource file 152 (FIG. 2) to get the path of the error page 
to be displayed. 

private void processException() - This method extracts the data from the exception and stores 
it in the ErrorlnfoBean for display to the user. This method also calls the log method. 

private void processCode() - This method stores the error code in the ErrorlnfoBean for 
display to the user. This method also calls the log method. 

protected void log() - This method controls storing information for logging. 

public Object clone() - This method returns a copy of this WPASystemErrorActionForward 
instance. 

[0070] [00711 The WPASystemErrorActionForward may use the ErrorlnfoBean object to 
store values that are later accessed by the error JSP page for display. There may be getter and 
setter methods for error code, UI message key, and title key. 

[0071] [00721 The following discussion relates to the design of the error catalog 210 (FIG. 
3). The error catalog 210 may provide exceptions with a centralized object that may be used 
to look up information by error code. Each service that creates its own concrete subclasses of 
SystemException must have an errorCode.properties file stored in an appropriate 
predetermined directory to define per SystemException error code the error name, error 
reason, and error recourse. Concrete subclasses of FrameworkException must also have 
similar error data recorded in an errorCode.properties file, but because those exceptions are 
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created within the framework of a web presentation architecture constructed in accordance 
with embodiments of the present invention, they reside in the framework's 
errorCode.properties file. The numerical portion of the error codes should fall within a range 
that defines a general description of the error. The ranges may also indicate a title key and UI 
message key that should be used with each error when displaying an error page to the user. 
In addition, the type of error action forward may indicate a title key and UI message key that 
should be used in certain occasions when displaying an error page to a user. This information 
may be portal specific and portal information that may be stored in the a configuration file 
such as the configuration file 212 (FIG. 3) may be used in conjunction with the error action 
forward name to indicate title keys and UI message keys. 

[0072] [00731 As set forth above, the error catalog 210 may be populated when the controller 
205 (FIG. 3) starts up (e.g. in the initO function of the controller 205). An 
ErrorCodeConfigurator may be among the configurators called during startup, and it may 
search for and open a configuration file for each service. Those of ordinary skill in the art 
will appreciate that a single configuration file may be used for storing information about all 
relevant services, if desired. The configuration file or files may be text properties files or the 
like. The properties are read and stored into an ErrorCodeMapper, then loaded into the 
ErrorCodeCatalog as ErrorCode objects or title and UI message data. 

[0073] 100741 The functionality associated with the error catalog 210 (FIG. 3) may comprise a 
plurality of classes, which may be referred to as "actors." Those actors may include the 
following: 

WPAController - the controller (for example, the controller 205 (FIG. 3)). 
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WPAConfiguratorController - the controller class that calls all the configurators, given the 
list as defined in a predetermined configuration file. 

ErrorCodeConfigurator - the configurator run during the controller initialization that opens 
the errorCode.properties file for each service. 

ErrorCodeMapper - where the data from the errorCode.properties files of the services are 
stored. 

Catalog - the abstract superclass of ErrorCodeCatalog. 

ErrorCodeCatalog - this object stores ErrorCode objects, searchable by error codes. This 
object also stores title key and UI message key data. 

ErrorCode - this object stores data about each exception: the error code, error name, error 
reason, and error recourse. 

[007 4 ] [00751 The following use case describes a typical course of events for a situation in 
which error data is loaded upon controller initialization: 

1 . During startup, the initQ method of the controller makes the proper calls so the 
configurator classes are run (using the WPAConfiguratorController). 

2. Among the configurator classes run is ErrorCodeConfigurator. 
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3. ErrorCodeConfigurator.configure() is called. This method uses the passed in 
ActionServlet parameter to obtain a servletContext. The servletContext is used to 
traverse the directory tree to find each service's errorCode. properties file. 

4. Once found, the errorCode.properties file of each service is opened and the data is 
loaded into the singleton ErrorCodeMapper object. 

5. ErrorCodeConfigurator then calls the configure() method of ErrorCodeCatalog. 

6. For each property in the mapper, the catalog calls registerHandler, a method 
inherited from its superclass, Catalog. The registerHandler method creates an 
ErrorCode object for each entry that was an errorCode mapping in the properties 
file. These entries are then stored by error code in the "handlers" hashtable of the 
ErrorCodeCatalog. Additionally, the method isolates the uiMessage entries and 
stores them separately in a "uiMessages" hashtable the ErrorCodeCatalog. 



[0075] [00761 The configuration file that is loaded by the controller at initialization may 
comprise three types of data: UI message key data, title key data and mapping data. The UI 
message key data may be defined as follows: 

<range> . <portal_name>=<UI_Msg_key > 
or 

<actionForwardName>.<portal_name>=<UI_Msg_key> 



where the range may take into account the numbering guidelines: 



System unavailable 
Service unavailable 
Database related errors 
File System errors 
Service errors 



10000 to 10999 
15000 to 15999 
20000 to 20999 
25000 to 25999 
30000 to 30999 
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and where UI_Msg_key comprises: <portalname>.error.<description_of_string> 
and where actionForwardName comprises the fully qualified pathname for one of 
WPASystemErrorActionForward or WPABusinessErrorActionForward. 

[0076] [00771 An example set of UI message definitions follows: 

10000-1 0999. example=example.error.system_unavail_msg 
1 5000-1 5999. example=example.error.service__unavail_msg 
20000-20999. example=example.error.db_err_msg 
25000-25999. example=example.error.file_sys_err_msg 
30000-30999.example=example.error.service_err_msg 

com.samplePath.WPASystemErrorActionFoiward.example=example.error.service_unavail_ 
msg 

com.samplePath.WPASystemErrorActionForward.example=example.error.service_unavail_ 
msg 

[0077] [00781 Title keys that are stored in configuration files may be defined according to 
the following format: 

<range>.title.<portal_name>=<Title_Msg_key> 
or 

<actionForwardName>.title.<portal_name>=<Title_Msg_key> 

where the range takes into account the numbering guidelines described above 

and where Title_Msg_key may comprise: <portal_name>.error.<description_of_string> (i.e. 

example, error. service_err_pg_ti tie), 

and where actionForwardName comprises the fully qualified pathname for one of 
WPASystemErrorActionForward or WPABusinessErrorActionForward. 

[007 8 ] [0079] An example follows: 
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1 0000- 1 0999.title.example=example.error.system_unavail_pg__title 
1 5000-1 5999.title.example=example.error.service_unavail_pg_title 
20000-20999.title.example=example.error.db_err_pg_title 
25000-25999.title.example=example.error.file_sys_err_pg_title 
30000-30999.title.example=example.error.service_err__pg_title 

com.samplePath.WPASystemErrorActionForward.title.example=example.error^ 
ail_pg_title 

com.samplePath.WPASystemErrorActionForward.title.example=example.erro^ 
ail_pg_title 

[0079] 100801 The third type of data in the errorCode.properties file is the mapping of error 
code to error name, error reason, and error recourse. An exemplary format for that mapping 
follows: 

errorCode=errorNamel jerrorReasonl |Recourse 
where the error code follows the format: 
<portal>-pl-<service>-errorCode 

{0080} [00811 An exemplary StartupException follows: 

sampleFramework-pl-sampleFramework-10999 : =StartupClassInitializationError|Error 
occurred during initializing startup classes at weblogic startup|Check startup_error.log file for 
any errors logged. 

[0081] [00821 FIG. 5 is an object diagram of an architecture for object classes associated 
with an error catalog in accordance with embodiments of the present invention. The diagram 
is generally referred to by the reference numeral 400. 
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[00 8 2] [00831 The ErrorCodeConfigurator class may implement the 
configure(ActionServlet) method defined in the Configurator interface. The ActionServlet 
parameter is used to locate and open the errorCode.properties files in the directory tree. The 
following method may be employed in conjunction with the ErrorCodeConfigurator class: 

public void configure(ActionServlet servlet). 

{0083} [00841 The ErrorCodeMapper class may store all the properties defined in the various 
service defined errorCode.properties files. It is a singleton object, and therefore can be called 
when the ErrorCodeCatalog is being configured. A singleton object is an object that exists in 
memory such that only one of that type of object exists at any time in memory. Once created, 
a singleton object is not destroyed after use, like most objects, but is kept in memory until 
accessed again. The following method may be employed in conjunction with the 
ErrorCodeMapper class: 

public static ErrorCodeMapper getlnstance() - Returns the instance of the ErrorCodeMapper. 

[008 4 ] [00851 The Catalog class is an abstract superclass of ErrorCodeCatalog. The 
registerHandler method that ErrorCodeCatalog inherits creates the ErrorCode objects from 
the data in the ErrorCodeMapper and stores them in a "handlers" hashtable. The title keys 
and UI message keys are also isolated and stored in a "uiMessages" hash table. If there is a 
problem encountered during this method, the FrameworkException RegisterHandleException 
is thrown. The following method may be employed in conjunction with the Catalog class: 
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public synchronized void registerHandler(String code, String value) throws 
RegisterHandleException. 

{0085} [00861 The ErrorCodeCatalog class is a concrete subclass of Catalog that creates an 
error catalog in its configure() method. For each entry stored in the ErrorCodeMapper, 
registerHandler() is called, and either an ErrorCode object is created, or the entry is 
recognized as a title key or UI message key entry. ErrorCode objects are stored in a hash 
table separate from the title and UI message hash table. The following methods may be 
employed in conjunction with the ErrorCodeCatalog class: 

public synchronized static ErrorCodeCatalog getlnstance() - ErrorCodeCatalog is a singleton 
object, so programmers may access it through its getlnstance() method. 

public void configure() - Creates the error catalog by accessing the ErrorCodeMapper and 
creating ErrorCode objects or storing title keys and UI message keys. 

{0085} [00871 The ErrorCode object holds information about an exception, as loaded from 
the errorCode.properties file, including error code, error name, error reason, and error 
recourse. In addition to the constructor, there are getter functions for each of the fields just 
named. The following constructor may be employed in conjunction with the ErrorCode 
object: 

public ErrorCode(String code,String name,String reason, String recourse). 
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{©086} [00881 While the invention may be susceptible to various modifications and 
alternative forms, specific embodiments have been shown by way of example in the drawings 
and will be described in detail herein. However, it should be understood that the invention is 
not intended to be limited to the particular forms disclosed. Rather, the invention is to cover 
all modifications, equivalents and alternatives falling within the spirit and scope of the 
invention as defined by the following appended claims. 
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